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Users’ Guide for ee9: an English Electric KDF9 Emulator 

by Bill Findlay 
( kdf9@findlayw.plus.com) 


0: Introduction 

This note is a guide for users of ee9, a program emulating the EE KDF9 computer. Readers not yet familiar with the KDF9 
should consult the companion document, The English Electric KDF9\ you will will be referred to the ‘Manual’ for further 
details; this is the KDF9 Programming Manual , the nearest thing we have to a definitive reference work. 

ee9 is intended to be portable to any system that offers a basic POSIX API. It is written in Ada 2012 using GNAT, the 
GNU Ada compiler. ee9 is available on the Intel x86_64 and x86_32 architectures; with macOS, Linux/FreeBSD, and 
Microsoft Windows. Older versions (still available) run on the ARM 11 architecture for the Raspberry Pi with Raspbian 
(Debian Linux for ARM) and on the PPC architecture with OS X. For the specific characteristics of this version, see §6. 

Note that the command syntax of this version differs significantly from that of earlier versions. Several important 
operational aspects related to paper tape PO and the external encoding of paper tape files also differ; see §1 and §3.4. 

See Appendix 1 for usage examples, and for descriptions of shell commands that make it easy to run some important 
KDF9 software using ee9. A list of ee9 error messages, with some further explanation, is given in Appendix 8. 

1: ee9 Command Summary 

The emulator is invoked from the command line, thus: 

./ee9 {-ss I -Ad I -m[w] I -TPff I -TR/r } +program^file_name 

where the parameters with a - flag are optional and can be given in any number or order; m is a short string that specifies a 
miscellany of options; d specifies a diagnostic execution mode; s is the initial CPU state for the KDF9 run; and tt specifies 
paper tape device character codes. 

The allowable state flag characters ,v are: 

• b: for booting into Director state, which is how operating systems are loaded and run 

• p: for problem program state, the default, allowing user programs to be run without a Director (see §2.2) 

• t: for test program state, allowing programs to be run with OUTs serviced as in problem program state, but with the 
CPU actually in Director state; though inauthentic, this is useful for running ‘hardware’ test programs. 

The allowable diagnostic flag characters d are: 

• f: for fast mode, the default 

• p: for pause mode 

• t: for trace mode 

• x for external trace mode 

The allowable characters in the string m are described in §5.2. 

The parameters tt specify the character code to be used by either one or two paper tape punches (with -TP), or paper 
tape readers (with -TR). tt is either one or two characters, each being either k/K or 1/L, specifying KDF9 code or Latin-1 
code respectively. If tt is one character, it refers to unit 0 of the type (i.e. TPO or TRO). If tt is two characters, the first refers 
to unit 0 and the second to unit 1 of the type. See also §3.4. 

Commands are available to simplify calls on ee9, in systems that support a bash-compatible shell. See Appendix 1. 

Examples 

./ee9 —dt —mn +KMW0201—UPU # KMW0201—UPU is the Whetstone Algol compiler 

./ee9 -sb -TRkk -TP11 +KKT40E007UPU # KKT40E007UPU is the Time Sharing Director 

2: Emulation Modes 
2.1: Diagnostic Modes 

A KDF9 program is run, at option, in one of four diagnostic modes. These are: 

• fast mode; in which ee9 runs the program at maximum speed, with no execution tracing or interactive diagnostic 
facilities available 

• pause mode, in which ee9 single-shots the program, pausing to interact with the user after each instruction 

• trace mode, in which ee9 runs the program at speed with extensive retrospective tracing enabled 

• external trace mode, in which ee9 writes a summary of every traced instruction to an external file 
More precisely, things work as follows. 

In fast mode ee9 interacts with the user only by providing informative messages, either because the KDF9 program has 
terminated, or to log significant events during the run (such as the allocation of an I/O device). All tracing overhead is 
avoided in fast mode. 

In pause mode ee9 uses console-window text I/O to interact with the user. After each instruction is executed a short 
summary of the machine state is displayed and a prompt asks the user how to continue. The user replies with an optional 
single letter (which may be given in upper case or lower case) followed by RETURN, selecting one of the following: 
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• f: execution proceeds in fast mode 

• p: execution proceeds in pause mode 

• t: execution proceeds in trace mode 

• (nothing): execution proceeds in the current mode. 

All retrospective tracing types described in §4 are available in pause mode, trace mode, and external trace mode; but the 
manner of execution depends on whether the current instruction execution lies within a set range of addresses, and within 
set instruction-count bounds. If so, instructions are added to their appropriate traces; and breakpoints and watchpoints are 
monitored. If not, execution proceeds as in fast mode (but at about a third of the speed). 

2.2: Run states 

The run state specifies how the emulated KDF9 is to run the program: 

• In boot mode the KDF9 reads a 9-word bootstrap routine from TRO, then jumps to word 0, in Director state. 

• In problem program mode ee9 reads into core, from TRO, a binary program prepared by a compiler. Its execution 
starts at word 0, in program state. ee9 itself implements any OUTs (system calls) requested by the program, so that it is 
not necessary to have a Director running. 

• In test program mode ee9 reads a binary program into core from TRO, just as in problem program mode. Its execution 
starts at word 0, but in Director state. The emulator implements any OUTs requested by the program. 

2.3: Breakpoints, Fetchpoints , Storepoints, and Watchpoints 

Certain addresses in core can be marked as breakpoints or as watchpoints, to force diagnostic interaction with the user. A 
breakpoint is set on an instruction word, and causes interaction after an instruction beginning in that word has been 
executed. A fetchpoint is set on a data word, and causes interaction after data has been fetched from that word. A 
storepoint is set on a data word, and causes interaction after data has been stored into that word. A watchpoint combines a 
fetchpoint and a storepoint on the same word. 

2.4: Authentic Timing Mode 

At option, ee9 can be made to insert timed pauses into its execution so that the elapsed time of a program run by ee9 
approximates the elapsed time of a run on the real KDF9 hardware. This may be instructive for younger users, who have 
never seen characters being output by a computer, one at a time, and with noticeable delays! This mode can be set using the 
authenticity setting, see under ‘A’ in §5.1, or by means of the command-line miscellany parameter t; see §5.2. 

3: Inputs and Outputs 
3.1: Emulated KDF9 I/O Devices 

At the start of a run ee9 casts around for hies to represent the virtual KDF9 peripherals. If no hie can be found for a 
peripheral, it may be reported to be ‘offline’. There is a fixed assignment for the console Flexowriter, which is associated 
with the user’s interactive terminal window. 

Other devices are associated with flies having names derived from the device type. Magnetic tape deck d, for example, 
is always associated with the hie named ‘MT d’. It will often be convenient to have hie system links of these names, which 
may be redirected for each run of the emulator to the actual data flies to be processed on that occasion. The full list of these 
associations is as follows: 

• card punches are ‘CP d’ 

• card readers are ‘CR d' 

• drum stores are ‘DR d' 

• fixed disc stores are ‘FDr/’ 

• graph plotters are ‘GP d' 

• line printers are ‘LPr/’ 

• KDF9 magnetic tape decks are ‘MT d' 

• IBM seven-track tape decks are ‘STc/’ 

• paper tape punches are ‘TP d’ 

• paper tape readers are 'TR d' 

3.2: The Flexowriter Console Typewriter 

The terminal window is the means by which users, in their role as KDF9 operators, can mimic Flexowriter I/O. The 
Flexowriter is used to type-in responses to prompts output by problem programs or by Director. Repeatedly typing these 
responses quickly becomes tedious. If a file named FW0 exists, it is used as a source of “canned” responses. They are 
defined, with their identifying prompts, in FW0; and are picked up automatically by ee9. If a prompt spreads over more 
than one line, a KDF9 Line Shift can be represented in FW0 by a ‘®’, and a KDF9 Page Change by a ‘©'. 

When a prompt is issued, ee9 scans FW0, down from the last match found. If it finds a new match, it injects the given 
response into the Flexowriter input stream; but if it reaches the end of the file without finding a match, it returns control of 
the Flexowriter to the user’s terminal window, so that a manual response can be given. If a prompt matches a line in FW0 
that specifies a null response string (c.f. the second ‘OUT; ’ in the following example) then ee9 terminates the run. 

For example, the Whetstone Algol compiler prompts ‘OUT; ’ to which a typical reply is ‘N. | ’. If the Algol program 
compiles, it runs and prompts ‘STREAM; ’ to which a typical reply is ‘30 . | but if the compilation fails the compiler loops 
back to its ‘OUT; ’ prompt, where the user will normally want to terminate the run so that the Algol source code can be 
amended. The following data in FW0 will achieve this without user intervention: 

OUT;N.| 

STREAM;30.| 

OUT; 
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For a second example, as the Time Sharing Director bootstraps it issues a series of requests for basic configuration 
parameters. The following data in FWO supplies suitable responses without user intervention: 

CORE MODULES;8.| 

OUT 8 REEL NO;9.| 

LEVELS;N.| 

DATE D/M/Y;4/5/67.| 

TIME ON 24-HOUR CLOCKSHOURS/MINS;1/23.| 

This facility had a real equivalent: the Flexowriter incorporated an ‘edge-punched card 7 reader. It read data (in paper 
tape code) from the edge of a non-standard punched card. Cards prepared with replies to prompts could be inserted into the 
reader and read at the maximum rate, thus speeding input and avoiding any delay due to typing errors by the operator. 

Note that ee9 requires every Flexowriter input string to be terminated by a Return, even when a read-to-End 
Message instruction is being obeyed. In reality, KDF9 would end the transfer immediately at the End Message, or when the 
required number of characters had been read; but data is not transferred to ee9’s input buffer until a Return is typed. A 
merely terminating Return is discarded from the input by ee9, and is not passed to the KDF9 program. 

In response to CTRL-C, ee9 outputs a prompt of its own that lets the diagnostic mode be changed. Replying with a 
Return (only) causes a FLEX interrupt; when running Director in boot mode, this evokes a ‘TINT ; ’ prompt. 

Output to the Flexowriter was typed in red; input from the computer operators was typed in black. This is simulated in 
ee9 by using ANSI-terminal escape sequences to vary the displayed font colour. The Windows cmd command-line utility 
does not implement ANSI terminal escape sequences, so Flexowriter FO under Windows is monochrome. 

3.3; Reading More Than One Roll of Paper Tape or Deck of Cards 

A means is provided to simulate the way in which KDF9’s computer operators could satisfy a program’s demand for data 
with several physically-separate rolls of paper tape, loaded into a tape reader in succession. If a program attempts to read 
from a tape reader, and the end of the associated file has been reached, ee9 allows the user to specify a successor file to 
which the paper tape reader is re-attached. These files are named ‘TRc/r’ where d is the device number (0 or 1) and r is a 
letter identifying the “roll of tape”. On reaching the end of the current file, ee9 asks for the next letter if none is given the 
reader is left in the ‘abnormal’ condition and any further attempt to read from it provokes a parity error. Again, it may be 
convenient for the files ‘TRr/r’ to be realized as links to actual data files with more mnemonic names. See the ‘N’ option in 
§5 about the disabling of this feature in non-interactive mode. 

The above also applies, mutatis mutandis, to the punched card reader, CRO. 

3.4: Representing the KDF9 Character Sets 

The KDF9 had its own, somewhat idiosyncratic, character sets. They are tabulated in Appendix 2. For the convenience of 
the user, external data read and written by the paper tape readers and punches may be represented in either KDF9 paper 
tape code, or in the ISO Latin-1 character set with automatic conversion between Latin-1 and KDF9 codes. 

Several characters in the KDF9 paper tape set are absent from Latin-1, so a simple transliteration is used to represent them 
externally. The break character is used for the non-escaping KDF9 underline, so that an Algol 60 reserved word such as 
‘real’, seen on a Flexowriter as ‘ real ’, appears as ‘_r_e_a_F, and an underlined End Message, appears as ‘_P. 

In the case of the Flexowriter, and for Latin-1 I/O with tape punches and tape readers. Case Normal and Case Shift 
characters are generated on input, and interpreted on output. This means that when you are typing an input text, it is not 
necessary to type Case Normal and Case Shift characters, although it does no harm to do so. When such a text is being read 
as the input stream for a two-shift device, an appropriate case-character is generated automatically by the emulator, if the 
Latin-1 character being read is not available in the input device’s current shift state. Two-shift output works in the 
complementary manner. Two-shift devices always start out in the Case Normal condition. 

For example, the external Latin-1 string ‘Bill Findlay’ may be read into the KDF9 core store as the characters 
"BBILL nFBINDLAY’, with B denoting the Case Shift character and n denoting the Case Normal character. A KDF9 
program that writes the characters ‘BBILL nFBINDLAY’ to a two-shift device in Latin-1 mode will generate the Latin-1 
string ‘Bill Findlay’ as its external representation. 

In KDF9 mode characters are transmitted verbatim to or from the KDF9 paper tape format (see the Manual, §17.4). 
Paper tape devices use an 8-bit byte externally, encoding the 6 internal data bits and two ‘parity’ bits. 

Text-file input to ee9 may use any of CR, LF, or a CRLF pair as the line terminator: ee9 treats all three the same. Text- 
file output from ee9 writes the line terminator most appropriate for the host OS. 

Non-graphic KDF9 characters also have Latin-1 external representations, to enable faithful 1-to-l inter-conversion 
between the internal and external data formats. Apart from the format effectors (Horizontal Tab, New Line, Form Feed), 
users should never need to type these characters, as they could not be typed on a Flexowriter. 

Characters are displayed in tracing output and core dumps using the line printer code, except as follows: 

• the KDF9 Tab character is represented by 

• the KDF9 Line Shift (Carriage Return) character is represented by ® 

• the KDF9 Page Change (Form Feed) character is represented by © 

• the KDF9 Filler, and other non-legible characters, are represented by 0 

Characters not in the punched card set are read as Filler by the card reader. Lines of less than 80 characters are padded 
with blanks to fill all 80 columns of the card; any line longer than a card is truncated. In ‘direct’ mode, lines may have up to 
160 characters, notionally two per card column. The card punch always writes files that are valid as input to the card reader 
and can be read to exactly reproduce the original data in core. 

Directors and other compiled programs are not encoded in Latin-1, but natively, in the KDF9 paper tape code. 
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3.5: Graph Plotting 

ee9 includes an emulation of the model 564 Calcomp graph plotter, as described in Appendix 6, §5, p.302 of the Manual 
(but see what I say about this in §6: Caveats). There was provision on the KDF9 to switch a buffer manually between a tape 
punch and a graph plotter; in ee9 this is done with a settings file option, G, or by including g in the miscellany parameter. 
When either is given, GPO replaces TP1 on the shared buffer. 

The KDF9 graph plotter takes commands that move the plotting position in steps of 0.005 inches; see Appendix 3 for 
the command codes. Steps are accumulated into vectors by ee9, and PostScript vector drawing commands are output to 
GPO, creating an Encapsulated PostScript (EPS) file. It is possible to ‘fit’ the plotter with pens having a variety of ink colour 
and bail-point tip size. See under ‘G’ in §5. 

4: Logging and Tracing 

Messages that record the progress of the emulation, and details of any errors that were detected, are written to the 
interactive console window, along with interactive diagnostics and output produced for the KDF9 Flexowriter. A selection 
of these messages is also written to the file KDF9_log.txt. On completion of a run, the final machine state, any 
requested core store areas, and any retrospective traces may be written to the log file and to the console window. 

It is possible to request the output of certain areas of the KDF9's core store, in a variety of suitable formats. These 
printouts can be taken either before the start of execution; or on termination; or at both times, to allow comparisons. 

In the interrupt trace, which is produced only in boot mode, interrupt requests are listed with the privilege state and 
priority of the interrupting device; the elapsed time of occurrence (in ps)\ and the value of ICR, the Instruction Count 
Register, which is a count of the number of instructions executed so far. 

The tracing of executed instructions is subject to instruction-count and address-range bounds. Instruction executions 
within those bounds are traced; those that fall outside the bounds are not. 

In the peripheral PO trace, the events shown are transfer initiations and terminations, busy-buffer and store-access 
lockouts, and I/O status test operations. Each is listed with the device name, Q-store parameter, privilege state (P for 
problem program state and D for Director state) and priority of the transfer; the elapsed time of occurrence of the event; and 
the current instruction count. 

The C part of the parameter used in a disc seek operation is logged in the format DdPppSss, where d, pp and ss are, 
respectively, the drive number, platter number and seek area number being addressed. In a disc data transfer d and pp are 
irrelevant and ss is the starting sector number for the transfer. 

The C part of the parameter used in a drum transfer is logged in the format SECTsssDP where d and .s.s.s' are the drive 
number and the starting sector number. 

Transfer operations appear twice, once for the initiation (S) and once for the termination (E). Lockouts appear once, 
when they happen. A test operation gives the result of the test as a Boolean. 

In the retrospective trace, instructions are listed in order, starting with the most recently executed. The trace includes the 
instruction itself, and its most relevant operand; ‘ND’ and ‘SD’, the Nest and SJNS Depths; ‘V’ and/or ‘T’ showing whether 
overflow and/or the test register is set; the CPU time of occurrence of the event; and the value the current instruction count. 
In the case of a store order, the traced operand is the value written to store. In the case of a fetch order, it is the value 
fetched. For a Q-store order, it is the content of the relevant Q register. For a conditional jump it is the determining value. 
For subroutine jump or exit, it is the relevant value in the SJNS. For a 1-syllable or 2-syllable ALU order, it is the value left 
in the top of the nest. And so on. 

External trace mode is like retrospective mode, with additional output to the file trace.txt. This output has one line for 
each traced instruction. It contains: the instruction’s address; the value of ICR; the CPU time; the nest depth; the SJNS 
depth; ‘V’ and/or ‘T’ if overflow and/or the test register is set; the value in Nl, if the nest if non-empty; and the 
disassembled instruction. 

When tracing, and if requested, ee9 will tally the number of traced executions of each type of KDF9 instruction. On 
termination of a run a histogram of dynamic instruction-type frequencies may be logged. A similar plot may be produced 
showing the frequency with which each instruction word is executed. 

At option, all tracing modes can compute a digital signature of the execution; a 48-bit cumulative hash, displayed in 
octal, of the contents of all the relevant KDF9 registers (nest, SJNS and Q stores) at the end of each traced instruction. 
Known values for this hash can be used to verify the proper operation of an implementation of ee9. (When the signature is 
enabled, the starting time-of-day is forced to midnight, to ensure a repeatable hash value.) 

For examples of the output that can be obtained using these facilities, see Appendices 7 a-7g. 
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5: The Mode Settings Files and Miscellany Parameter 

The emulator has default settings for all of its options, but they may be over-ridden by settings specified in files that the 
emulator attempts to read as part of its initialization, and/or by specifying a miscellany parameter on the command line. 

5.1: Settings Files 

The file settings_l .txt applies to a first or sole program to be run, and settings_2 .txt applies to a second 
program overlaid by it (e.g. the Whetstone Controller, overlaid after a successful compilation by the Translator). A setting 
specified by the command line over-rides a similar option specified in the settings_l. txt file. 

The settings files contain a line for each option to be set, beginning with a letter that specifies the option concerned. This 
may be followed by one or two parameters. Address parameters may be given in octal—preceded by a hash sign (“#’)—or 
in decimal; and this convention is also used systematically in output messages from the emulator. The options are presented 
here in upper case, but lower/mixed case is also accepted. The available options are as follows: 

A LAX_MODE I STRICT_MODE I AUTHENTIC_TIME_MODE 

The A flag sets aspects of the AUTHENTICITY of execution. It takes one symbolic parameter. 

It is possible to set the strictness that ee9 applies to checking for misused register operands, with a parameter that is 
either LAX_MODE or STRICT_MODE. In STRICT_MODE an operation with n operands fails if the nest depth is less than n. 
In LAX_MODE such an operation fails if, and only if, it further reduces the nest depth. The latter more closely approximates 
the behaviour of the KDF9 nest hardware. 

This mode also affects instructions that attempt to change the value of Q store 0, which was hardwired to a constant 0 
and ignored updates. In LAX_MODE an assignment to Q0 is suppressed, which is what the hardware did; in STRICT_MODE 
it is treated as an execution error (unless running in Director state), which is a diagnostic more likely to be useful. 

In LAX_MODE the FRB and TOB orders allow a radix > 31; in STRICT_MODE this is an error. 

It is also possible to set authentic elapsed timing (see §2.4), with the AUTHENTIC_TIME_MODE parameter. 

B start [ end ] 

This flag has either one or two parameters, which are instruction-word addresses. It sets a BREAKPOINT on every instruction 
word in the given range of addresses. 

C / h 

This flag is used to set two COUNT values, say / and h, that determine when tracing is done. No breakpoint or watchpoint 
fires, and no instruction is traced, unless l < i < h is satisfied; where i is the current value of ICR. With suitable / and h 
values, tracing can confined to a set time during execution (for example, the last few instruction executions before a 
program fails). The values / and h are given as unsigned decimal integers. 

D FAST_MODE I TRACE_MODE I PAUSE_MODE I EXTERNAL_MODE 

This flag sets the DIAGNOSTIC mode, specifying the type of tracing and the kind of logging that may be generated. 

F i start end and I i start end 

These flags have two parameters, which are word addresses. They request that the contents of that range of addresses be 
output in a specified interpretation, INITIALLY, or FINALLY (i.e. after the end of the run). 

For both I i and Fi, the interpretation is given by the string of letters i, each letter of which must be one of: A, for strings 
in ASCII/Latin- 1 code; C, for strings in card code; L, for strings in LlNEPRlNTER code; N, for strings in paper tape code, 
with case NORMAL shown; S, for strings in paper tape code, with case SHIFT shown; T, for strings in paper TAPE code, with 
shift characters actioned; O, for syllabic OCTAL/ ORDERS; U, for orders in pseudo-USERCODE format; and W, for data WORDS 
in octal, syllabic octal, line printer characters, Q store format, and signed decimal. 

When U is specified, D can also be given to display machine code addresses in DECIMAL instead of octal. For an example 
of pseudo-Usercode format, see Appendix 6. 

The PIC. PID, POC and POD instructions for cards and paper tape permit the processing of data in arbitrary character 
codes. The A format for core-store printing is provided to facilitate the debugging of modern KDF9 programs that process 
data in ASCII/Latin-1, the native character set of ee9. 

G [ colour [ tip size ] ] 

This flag allows one or two optional symbolic parameters. The first, if given, sets the GRAPH PLOTTING pen colour from the 
list: BLACK (the default), BLUE, BROWN, CYAN, DARK_BLUE, DARK_CYAN, DARK_GREEN, DARK_GREY, 
DARK_MAGENTA, DARK_RED, GREEN, GREY, MAGENTA, RED, WHITE, YELLOW. If a colour is given, a second parameter 
may be given to set the pen tip size from the list: EXTRA_EXTRA_FINE (the default, 1 plotter step wide), EXTRA_FINE 
(2 steps wide), FINE (4 steps), MEDIUM (6), MEDIUM_BROAD (8), BROAD (10), EXTRA_BROAD (12). 

In any case, the shared buffer is switched from TP1 to GP0. 

H h cutoff% 

In tracing mode, ee9 collects statistics on the execution of the KDF9 program. These may be displayed at the end of a run in 
the form of histograms. Two plots are available. If h contains P or p, an execution-frequency profile is output. If h contains 
T or t, then an instruction type frequency histogram is output. Both may be requested, cutoff is a number in the range 0.0 to 
100.0, taken to be a percentage; the % is required to follow the number immediately. Histogram bins that account for less 
than that fraction of all executed instructions are suppressed. Nothing is output if the option is suppressed by the miscellany 
parameter. 
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L[f] 

This flag is used to set a value, say t, that specifies an execution time LIMIT. This determines how long the KDF9 program 
is allowed to execute before being terminated. The limit is specified in instruction executions rather than seconds, so the 
program is terminated if ICR > f at the end of any instruction execution. The value t is given as an unsigned decimal 
integer. If the L flag is given without a parameter, or on the command line, the time limit is taken to be the default time 
limit for non-interactive mode (see §6). 

N [/] 

The N flag has one optional parameter, with the same meaning at the t parameter of the L flag. It makes ee9 run in NON- 
INTERACTIVE mode, suitable for invocation from a command script. In this mode it is not possible to supply responses to 
prompts, whether from the KDF9 program or from ee9 itself; so if an interactive input is requested in non-interactive mode, 
ee9 terminates with a suitable diagnostic message. If the N flag is given without a parameter, or on the command line, the 
time limit is taken to be the default time limit for non-interactive mode (see §6). 

O 

The O flag outputs the current state of the diagnostics just before OUT1 is actioned; or just after, if the Q flag is also given. 

P address value 

This flag is used to POKE the value (given in octal or decimal) into the address. The address takes the form of an octal or 
decimal number, immediately followed by one of the letters W, U, L, S or C. If W is specified, the value overwrites the whole 
word at the address. If U or L is given, the value overwrites the specified halfword. If S or C is given, it must be followed 
by the position within the word of the syllable or character, respectively, to be overwritten. If a part-word is specified, the 
value must be within its storable range. 

Q 

The Q flag outputs any specified pre-run dumps and then quits. It is useful for getting a dis-assembly of a program without 
running it. 

R a b 

This flag is used to set two addresses, say a and b , that delimit the RANGE of instructions where tracing is done. No 
breakpoint or watchpoint fires, and no instruction is traced, unless a < i < b is satisfied; where i is the address of the word 
containing the instruction to be executed. With suitable a and b values, instruction tracing can confined to the sequence of 
instructions that you are currently debugging. 

S start [ end ] 

This flag has either one or two parameters, which are data-word addresses. It sets a STOREPOINT on every word in the given 
range of addresses. 

T BOOT_MODE I PROGRAM_MODE I TEST_PROGRAM_MODE 

This flag is used to set the TEST mode, specifying the kind of run. 

V {ADEFHIPRSTZ} 

The V flag is used to set the VISIBILITY of diagnostic output, by stating the set of traces that are to be suppressed. It is 
immediately followed by a selection of the letters: ‘A’ to suppress Director API messages, ‘E’ to suppress confirmatory or 
warning messages, but not error messages, from ee9, ‘F’ to suppress the FINAL STATE of the KDF9 at the end of a run, ‘H’ 

for the HISTOGRAMS, ‘I’ for the INTERRUPT trace, ‘P’ for the PERIPHERAL I/O trace, ‘R’ for the RETRO trace, and ‘S’ for the 

digital SIGNATURE. ‘Z’ combines the effects of all the output-suppression options. 

A trace is output if it is provided by the requested diagnostic mode, and its output is not suppressed. 

The default is that all traces provided by the diagnostic mode are to be output, i.e. not suppressed. 

The option ‘D’ can be given with the V flag, to enable the output of any optional DEBUGGING output. 

The option ‘T’ can be given with the V flag, to enable execution with authentic Timing (see §2.4). 

W start [ end ] 

This flag has either one or two parameters, which are data-word addresses. It sets a WATCHPOINT (i.e., a FETCHPOINT and a 
STOREPOINT) on every word in the given range of addresses. Note that it is not possible to set a FETCHPOINT only. 

X 

The X flag over-rides other diagnostic options and runs the program in external tracing mode with only signature generation 
enabled. 

5.2: The Miscellany Parameter 

The options permitted with the miscellany parameter on the command line are as follows: 
adefghilnopqrstxz0123456789 

The letters gin correspond with settings file commands G, L and N, with the defaults stated above for their optional 
parameters. The letters adefhiopqrstxz correspond with the obvious settings-file visibility options. A digit d requests 
an execution time limit of (r/+l)xl ()_()()()_()()() instructions. The miscellany parameter is scanned and put into effect from 
left to right. 
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6: Implementation Characteristics and Caveats 
Characteristics 

The defaults for the settable options in the present implementation of ee9 are as follows: 

• the default test mode is PROGRAM_MODE 

• the default diagnostic mode is FAST_MODE 

• the default diagnostic visibility generates all traces, the digital signature, and the histogram 

• the default is to run interactively; that is, with non-interactive mode disabled 

• the default register checking mode is STRICT_MODE 

• the default elapsed time mode is not AUTHENTIC_TIME_MODE 

• the default time limit allows for effectively unlimited execution 

• the default time limit in non-interactive mode is 100 million instruction executions. 

• the default count bounds, l and h, are 0 and the time limit, respectively 

• the default range bounds, a and b, are #0 and #7777, respectively 

• no breakpoint, watchpoint, storepoint, or core dump is pre-set 

• the shared buffer is switched by default to TP1, not GP0 

• the default graph plotter pen colour is BLACK 

• the default graph plotter pen tip is EXTRA_EXTRA_FINE (1 plotter step wide) 

The following features of KDF9 are not yet implemented: 

• all I/O orders for the ST (IBM magnetic tape) device type 

• OUTs other than OUT 0 through OUT 10, and OUT 17 (see Appendix 4) 

Caveats 

• KDF9’s nest-depth checking caused a NOUV interrupt after the maximum or minimum depth had been transgressed. 
Presently, ee9 checks for all of these violations before the offending instruction is executed. This makes little difference 
in practice. KDF9 had ‘imprecise’ interrupts, which made recovery from a NOUV error impossible: Director could do 
no more than terminate (or perhaps restart) the offending program. (See also the A option, §5.) 

• There is some doubt as to the semantics of the various division instructions, particularly with respect to rounding, and 
their behaviour on overflow and on division by zero (other than setting the overflow bit). 

• All of the I/O orders that apply to model 1081 tape decks (the most common kind) have been implemented. The former 
restriction of block length has been lifted, allowing blocks of up to 4096 words, which is somewhat more than the 
maximum suggested in the Manual for reliable operation. ee9 detects and fails an attempt to erase tape using MGAP 
other than in a length of tape already erased by MWIPE. There are many other possible tape usage errors (such as 
writing a block partly over another block) which are not detected and may lead to erroneous results. 

• The POK and POL orders are fully implemented for the CP and FD devices, which specify the effects these orders. 

• There is considerable doubt as to the effects of the PMG, PMK, PML, POK, and POL orders for all other devices. 

• It is assumed that the POL order for the TP device type has exactly the same functionality as the POE order. 

• The PIC, PID, POC and POD orders for LW, TR and TP devices terminate after a word that has the Latin-1 code for a 
vertical bar (#124) in its least significant 8 bits. This is not authentic (KDL9 stopped on a word that had #75 in its paper 
tape code data channels, ignoring the parity and channel 8 bits) but it is convenient. 

• The POC and POD orders switch LW from writing to reading after a word that has the KDL9 code for the semicolon in 
its least significant 6 bits. 

• It is assumed that the POB and POD orders for the graph plotter have the same effect as POA and POC, respectively, as 
the Manual says that the plotter did not respond properly to an End Message character. 

• It is assumed that the graph plotter pen tip sizes and colours are the same as those of pens currently on sale. 

• It is assumed that the plotter command codes listed in Appendix 6, §5, p.302 of the Manual are wrong, as there is an 
error whereby 11 plotting codes are claimed but only 9 are given. The codes used by ee9 are given in Appendix 3. These 
have been confirmed by evidence from other computers of the era that had the same type of plotter. 

• It is assumed that the fixed-head area of the disk is platter 16, seek area 0. 

• It is assumed that the drum has 20 tracks of 16 sectors, pairs of tracks being interleaved into 10 ‘bands’. This is based on 
the specification of the drum of the Philco 2000 computer, the only unit of the era with the same distinctive combination 
of attributes: similarly small capacity and exactly the same exceptionally high transfer rate. 

• Many other guesses have been made in emulating discs and drums; it remains to be seen whether they are justified. 

• The LRB and TOB orders deliver results that differ from the KDL hardware in unusual cases involving radix values 
greater than 31, which are stated to be illegal in the Manual, and to malfunction in the hardware documentation. 

• The emulation of OUT 8 by ee9 has some differences from the authentic behaviour of Directors; see Appendix 5. 

• Errors can occur during emulation. Some are defined by the KDF9 architecture to cause a LIV interrupt in program 
state, and ee9 implements that. Most interrupts, including LIV, are deferred in Director state, but ee9 cannot do this, as it 
might make continued emulation impossible. Other failures were not detected by the KDF9 hardware, but are apparent 
to ee9. All such erroneous conditions lead to a controlled end of the run, with diagnostics according to the user’s 
options. See Appendix 8 for a list of the various errors and their classification. 
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Appendix 1: Using ee9 More Conveniently 

To reduce the typing required to invoke ee9 correctly, I provide a set of bash command files, namely nine_test, nine, 
whet, stone, and tsd. These are kept in the Testing directory of the ee9 distribution, along with a number of auxiliary 
command files. Usercode source programs and their data files are kept in Testing/Assembly; Algol source programs 
and data files are kept in Testing/Algol; and compiled Usercode programs are kept in Testing/Binary. 

To facilitate the assembly of Usercode programs, I also supply the ucc command. This provides a convenient harness 
for kal3; it takes the source program from Assembly and places the object program in Binary. 

All of these programs expect to be executed from the Testing directory. Using them on Microsoft Windows requires 
either a bash-compatible shell, such as the one included in Cygwin, or Windows 10 Linux compatibility mode. 

ucc prog 

This command compiles a Usercode source program using the kal3 assembler. The source code is taken from 
Assembly/prog. k3 and the object program is placed in Binary /prog, while a compilation listing is stored in 
Assembly/prog-listing. txt. 

Example 

To compile Assembly/HIGUYS . k3: 

./ucc HIGUYS 


nine prog {data I - } {[ mode I - ] [miscellany I - ] [ kk I 11 I k I 1] [ kk I 11 I k I 1] } 

This command runs a binary KDF9 problem program, as previously assembled using ucc or kal3. The program is taken 
from Binary/prog; the data file for TR1, if required, is taken from Assembly/c/a/a.txt. The mode , miscellany and 
TP/TR character code parameters are as described in §1 (but note the different format); the defaults are as for ee9 itself. 

Example 

To run Binary/LEECH in default mode; but with all logging output suppressed; taking its TR1 data from 
Assembly/Leech_data9.txt: 

./nine LEECH Leech_data9 

Result: 

In TPO: 


AEFDBC 

A 

B 

C 

CCC 

FACA 

DFDC 

DBDB 

FBCEE 

BBBBBBB 

AEABAEAB 

AEEAEABBB 

ADADADADAD 

ABCDEABCDEABCDEABCDEABCDEABCDEABCDE 
1045 I 


nine_test prog {data I - } {[ mode I - ] [miscellany I - ] [ kk I 11 I k I 1] [ kk I 11 I k I 1] } 

This command operates exactly like the nine command, except that the program in Binary/prog is executed in 

test_program mode. 


crnine prog {data I - } {[ mode I - ] [miscellany I - ] } 

This command operates exactly like the nine command, except that the data file, if specified, is made available as CR0. 
whet prog {[ mode I - ] [miscellany I - ] [ kk I 11 I k I 1] [ kk I 11 I k I 1] } 

This command runs the Whetstone Algol system on the Algol 60 program and its ‘stream 20’ input data, held sequentially 
in the file Algol /prog. a60 and read respectively by the Translator and the Controller. The mode, miscellany and TP/TR 
character code parameters are as described for nine. 

stone [1976] 

This command compiles and runs the Whetstone Benchmark program using whet. If the 197 6 parameter is given, it runs 
in authentic timing mode; in other words, about as slowly as it did in 1976 on a real KDF9. 

Example 

To compile and run the historical Whetstone Benchmark, Algol/Whetstone. a60, in the fast mode: 

./whet WHETSTONE 
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Result: 

OUT ; N . | 

ee9: OUT 5: requests a device of type #02; gets TR1; using Latin-1 code. 

WHETSTONEBMK| 

RAN/EL/000M05S/000M15S SIZE 603 
ee9: OUT 6: released TR1. 

ee9: OUT 1: ICR = 813081; RAN/EL = 4823047 / 20248092 KDF9 us. 

Running the KDF9 problem program in fast mode (no tracing). 


STREAM; 30.| 

AD - S 

AD 30 CLOSED 

RAN/EL/006M54S/006M56S 

ee9: OUT 1: ee9 will not return to the Whetstone Translator. 


Final State: 


At #03016/1 
CIA: 

NIA: 

ORDERS: 

CPU TIME: 
CLOCK TIME: 


(1550/1); ICR = 74907394; the instruction was #200:220:000, i.e. OUT 
#03016/1 (1550/1) 

#03016/4 (1550/4) 

74907394 executed (ICR) 

419073756 KDF9 us. (RAN) 

442262593 KDF9 us. (EL) 


The SJNS is empty. 


Q store: 


Ql: Q 

#064773/ 

#000002/ 

#001125 

= 

Q 

27131/ 

2/ 

597 

Q2 : Q 

#000040/ 

#000015/ 

#001124 

= 

Q 

32/ 

13/ 

596 

Q3: Q 

#000001/ 

#001124/ 

#011443 

= 

Q 

1/ 

596/ 

4899 

Q4 : Q 

#000040/ 

#000001/ 

#001133 

= 

Q 

32/ 

1/ 

603 

Q6: Q 

#000000/ 

#007217/ 

#007223 

= 

Q 

0/ 

3727/ 

3731 

Q7: Q 

#000000/ 

#000000/ 

#000024 

= 

Q 

0/ 

0/ 

20 

Q8: Q 

#000030/ 

#177777/ 

#007203 

= 

Q 

24/ 

-1/ 

3715 

Q9: Q 

#000171/ 

#077640/ 

#077600 

= 

Q 

121/ 

32672/ 

32640 

Q10: Q 

#000000/ 

#000301/ 

#007203 

= 

Q 

0/ 

193/ 

3715 

Ql 1: Q 

#000036/ 

#000000/ 

#000000 

= 

Q 

30/ 

0/ 

0 

Q12 : Q 

#000030/ 

#177777/ 

#077700 

= 

Q 

24/ 

-1/ 

32704 

Q13: Q 

#000037/ 

#077700/ 

#077705 

= 

Q 

31/ 

32704/ 

32709 

Q14: Q 

#000000/ 

#000001/ 

#007202 

= 

Q 

0/ 

1/ 

3714 

Q15: Q 

#000003/ 

#000002/ 

#007203 

= 

Q 

3/ 

2/ 

3715 


The NEST is empty. 


End of Run. 
FW0 on buffer 
TR1 on buffer 
TP0 on buffer 
LP0 on buffer 


#00 typed 130 characters. 

#02 read 5416 characters in Latin-1 code. 
#04 punched 552 characters in Latin-1 code. 
#05 printed 13 lines. 


TP0: 


LINE 18 REL 
END COMMENT 

LINE 

8 

POSITION 

IDENTIFIER 

lab 

LINE 24 REL 
END COMMENT 

LINE 

5 

POSITION 

IDENTIFIER 

pO 

LINE 32 REL 
END COMMENT 

LINE 

7 

POSITION 

IDENTIFIER 

p3 

LINE 46 REL 
END COMMENT 

LINE 

13 

POSITION 

IDENTIFIER 

pout 


IDENTIFIER a NOT USED 

DECLARED ON LINE 2 

IDENTIFIER b NOT USED 

DECLARED ON LINE 2 

IDENTIFIER c NOT USED 

DECLARED ON LINE 2 

RAN/EL/000M05S/000M15S SIZE 603 
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LPO : 


N= 0 

J= 

0 

K= 

N= 120 

J= 

140 

K= 

N= 140 

J= 

120 

K= 

N=3450 

J= 

1 

K= 

N=2100 

J= 

1 

K= 

N= 320 

J= 

1 

K= 

N=8990 

J= 

1 

K= 

N=6160 

J= 

1 

K= 

N= 0 

J= 

2 

K= 

N= 930 

J= 

2 

K= 


0 Xl=+1.00000000 
120 Xl=-0.06834220 
120 Xl=-0.05533645 

1 Xl=+1.00000000 

2 Xl=+6.00000000 
2 Xl=+0.49040732 
2 Xl=+1.00000000 

2 Xl=+3.00000000 

3 Xl=+1.00000000 
3 Xl=+0.83466552 


X2=-l.00000000 
X2=-0.46263766 
X2=-0.44743656 
X2=-l.00000000 
X2=+6.00000000 
X2=+0.49040732 
X2=+l.00000000 
X2=+2.00000000 
X2=-l.00000000 
X2=+0.83466552 


X3=-l.00000000 
X3=-0.72971839 
X3=-0.71097339 
X3=-l.00000000 
X3=-0.71097339 
X3=+0.49039250 
X3=+0.99993750 
X3=+3.00000000 
X3=-l.00000000 
X3=+0.83466552 


X4=-l.00000000 
X4=-l.12397907 
X4=-l.10309806 
X4=-l.00000000 
X4=-l.10309806 
X4=+0.49039250 
X4=+0.99993750 
X4=-l.10309806 
X4=-l.00000000 
X4=+0.83466552 


RAN/EL/006M54S/006M56S 


tsd {[ mode I - ] [miscellany I - ] [ kk I 11 I k I 1] [ kk I 11 I k I 1] } 

tsd runs the Time Sharing Director (the original KDF9 operating system from English Electric) in the specified manner. The 
parameters are as described for nine. See Appendix 9 for a primer on console operating with the Time Sharing Director. 

This is how Director presently boots, with the supplied FW0 file. It shows buffer #15 being declared, a failed attempt to load 
a program from TR1 , and the tape reel on buffer #14 being relabelled: 

Booting the KDF9 Director Binary/KKT40E007UPU in fast mode (no tracing). 


P 

KKT40E007UPU 

TIME SHARING DIRECTOR 2464 WDS| 

02U01 

02U02 

05U03 

01U04 

03U05 

10U07 

10U10 

10U11 

10U12 

10U13 

10U14 

CORE MODULES; 8.| 

OUT 8 REEL NO;23001C.| 

A-PROGRAM DETAILS| 

LEVELS ;N.| 

DATE D/M/Y; 23/9/69.| 

TIME ON 24-HOUR CLOCK 
HOURS/MINS; 10/29.|*C 

Breakpoint: (d:ebug | f:ast | t:race | p:ause or q:uit)? 

TINT;L15/10 .| 

10L14 /Iden<+KOUTPUT/0023004>,TSN -00-2339 

10L13 /Iden<MS-DUMP.>,TSN 77777777 

10L12 /Iden<EFPBEAAG>,TSN -00-0552 

10L11 /Iden<_Z_E_R_0>,TSN 00000000 

10L10 /Iden<WHETLIST>,TSN -00-1234 

10U15 "C 

Breakpoint: (d:ebug | f:ast | t:race | p:ause or q:uit)? 

TINT;T0/30280 .| 

10L15 /Iden<PRINTEND>,TSN 0-00-929 
0 BPIU 02P 
0 CRNP F2 
02U02 ~C 

Breakpoint: (d:ebug | f:ast | t:race | p:ause or q:uit)? 

TINT; Z14.| 

TN/ID ;N/+EDCBA9876543210.| 

10L14 /Iden<+EDCBA9876543210>,TSN -00-2339~C 
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Breakpoint: (d:ebug | f:ast | t:race | p:ause or q:uit)? 


TINT;G.| 

02U01 

02U02 

05U03 

01U04 

03U05 

10U07 

10L10 WHETLIST 
10L11 _Z_E_R_0 
10L12 EFPBEAAG 
10L13 MS-DUMP. 

10L14 +EDCBA9 876543210 
10L15 PRINTEND^C 

Breakpoint: (d:ebug | f:ast | t:race | p:ause or q:uit)? q 
Run stopped by user! 


Final State: 


At #00201/5 (129/5); ICR = 816855493; the instruction was #202:305:357, 
CIA: #00201/5 (129/5) 

NIA: #00202/1 (130/1) 

ORDERS: 816855493 executed (ICR) 

CPU TIME: 4296173352 KDF9 us. (RAN) 

CLOCK TIME: 4356582203 KDF9 us. (EL) 


i.e. JE#00173/4GEZ 


The CPU is in DIRECTOR_STATE 

CONTEXT: 0 

PRIORITY: 0 

BA: #000000 

NOL: #077777 

C P DAR: UUUUUUUUUUUUUUUU 

PHU stores: 

CPL 0 is idle 
CPL 1 is idle 
CPL 2 is idle 
CPL 3 is idle 
RFIR (Interrupt Flags): 

PR: FALSE 

FLEX: FALSE 

LIV: FALSE 

NOUV: FALSE 

EDT: FALSE 

OUT: FALSE 

LOV: FALSE 

RESET: FALSE 


The SJNS is empty. 


Q store: 


Q5: 

Q 

#000000/ 

#177073/ 

#133772 

= Q 

0/ 

-453/ 

-18438 

Q6: 

Q 

#000000/ 

#177777/ 

#000000 

= Q 

0/ 

-1/ 

0 

Q7 : 

Q 

#000000/ 

#000000/ 

#100076 

= Q 

0/ 

0/ 

-32706 


V is set. T is clear. 


NEST: 


N1: 

#7777777777742757 = -14865 

= Q #177777/ #177777/ #142757 
= #377 #377 #377 #377 #305 #357 


-4.600494670994E+30 
Q -1/ -1/ -14865 

"00000070" 


End 

of 

Run. 









FW0 

on 

buffer 

#00 

typed 680 characters. 





TR0 

on 

buffer 

#01 

read 22398 

characters in KDF9 

code. 



TR1 

on 

buffer 

#02 

read 64 characters in KDF9 code. 




MT0 

on 

buffer 

#10 

read/wrote 

16 

characters, and 

is 

now 

at 

BOT. 

MT1 

on 

buffer 

#11 

read/wrote 

16 

characters, and 

is 

now 

at 

BOT. 

MT2 

on 

buffer 

#12 

read/wrote 

16 

characters, and 

is 

now 

at 

BOT. 

MT3 

on 

buffer 

#13 

read/wrote 

16 

characters, and 

is 

now 

at 

BOT. 

MT4 

on 

buffer 

#14 

read/wrote 

72 

characters, and 

is 

now 

at 

BOT. 

MT5 

on 

buffer 

#15 

read/wrote 

16 

characters, and 

is 

now 

at 

BOT. 
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Appendix 2a: KDF9 Internal Character Codes and their Transcriptions 


Line printer 

SP 


LF 

FF 

HT 


% 

1 

Card Reader 

SP 

ISO:" 

LF 

FF 

HT 

ISO:# 

% 

1 

Normal Case 

SP 

ISO:" 

LF 

FF 

HT 

ISO:# 

CS ISO:B 

CN ISO:n 

Shift Case 

SP 

ISO:" 

LF 

FF 

HT 

ISO:# 

CS ISO:B 

CN ISO:n 

Octal code 

00 

01 

02 

03 

04 

05 

06 

07 


Line printer 


= 

( 

) 

£ 

* 

9 

/ 

Card Reader 


= 

( 

) 

£ 

* 

9 

/ 

Normal Case 

ISO:& 

ISO:? 

ISO:! 

ISO:% 

ISO: ' 

ISO:$ 

ISO:- 

/ 

Shift Case 

ISO:& 

ISO:? 

ISO:! 

ISO:% 

ISO: ' 

ISO:$ 

ISO:- 


Octal code 

10 

11 

12 

13 

14 

15 

16 

17 


Line printer 

0 

1 

2 

3 

4 

5 

6 

7 

Card Reader 

0 

1 

2 

3 

4 

5 

6 

7 

Normal Case 

0 

1 

2 

3 

4 

5 

6 

7 

Shift Case 

t ISO: A 

[ 

] 

< 

> 

= 

X 

H- 

Octal code 

20 

21 

22 

23 

24 

25 

26 

27 


Line printer 

8 

9 


10 ISO: s 

* 

+ 

- 


Card Reader 

8 

9 

ISO: 

io ISO: 2 

’ 

+ 

- 


Normal Case 

8 

9 

ISO: 

io ISO: 2 


+ 

- 


Shift Case 

( 

) 

ISO: 

£ 


* ISO:± 

* 

, 

Octal code 

30 

31 

32 

33 

34 

35 

36 

37 


Line printer 


A 

B 

C 

D 

E 

F 

G 

Card Reader 

ISO:@ 

A 

B 

C 

D 

E 

F 

G 

Normal Case 

ISO:@ 

A 

B 

c 

D 

E 

F 

G 

Shift Case 

ISO:@ 

a 

b 

c 

d 

e 

f 

g 

Octal code 

40 

41 

42 

43 

44 

45 

46 

47 


Line printer 

H 

I 

J 

K 

L 

M 

N 

O 

Card Reader 

H 

I 

J 

K 

L 

M 

N 

O 

Normal Case 

H 

I 

J 

K 

L 

M 

N 

o 

Shift Case 

h 

i 

j 

k 

1 

m 

n 

0 

Octal code 

50 

51 

52 

53 

54 

55 

56 

57 


Line printer 

P 

Q 

R 

S 

T 

U 

V 

W 

Card Reader 

P 

Q 

R 

S 

T 

U 

V 

W 

Normal Case 

P 

Q 

R 

S 

T 

u 

V 

W 

Shift Case 

P 

q 

r 

S 

t 

u 

V 

W 

Octal code 

60 

61 

62 

63 

64 

65 

66 

67 


Line printer 

X 

Y 

Z 






Card Reader 

X 

Y 

z 

ISO: { 

ISO:} 

^ISO 

| 

ISO:\ 

see note 

Normal Case 

X 

Y 

z 

ISO: { 

ISO:} 

-*ISO 

j 

ISO:\ 

see note 

Shift Case 

X 

y 

z 

ISO: { 

ISO:} 

^ISO 


ISO:\ 

see note 

Octal code 

70 

71 

72 

73 

74 

75 

76 

77 


Notes 

The transcription provides a Latin-1 representation for every KDF9 internal character code: 

• SP is a blank space 

• LF is Line Feed, Line Shift (LS) in KDF9 terminology; it prints as ® in NEST displays 

• FF is Form Feed, Page Change (PC) in KDF9 terminology; it prints as © in NEST displays 

• HT is Horizontal Tab; it prints as in NEST displays 

• CS is Case Shift 

• CN is Case Normal 

• ‘y ISO:x’ indicates that x is the ISO Latin-1 transcription of the non-Latin-1 KDF9 character y 

• TSO:x’ indicates that x is the ISO Latin-1 external representation of a non-legible KDF9 character 

• Fast devices (e.g. magnetic tapes) always use the Normal Case representation 

• Code 77 is represented by 0: on two-shift devices (such as the Flexowriter) for ‘character mode 7 transfers only, but on 

punched card devices and fast devices invariably 

• If a cell is empty, that code is completely suppressed by the line printer 

• Except for ‘character mode’ output, B and n are acted upon by the Flexowriter, not transferred literally, so that output 

is presented in the correct case. 
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Appendix 2b: KDF9 Paper Tape Codes (with parity channels) and their Transcriptions 


Line printer 

SP 


LF 

FF 

HT 


% 

1 

Card Reader 

SP 

ISO:" 

LF 

FF 

HT 

ISO:# 

% 

1 

Normal Case 

SP 

ISO:" 

LF 

FF 

HT 

ISO:# 

CS ISO:J3 

CN ISO:n 

Shift Case 

SP 

ISO:" 

LF 

FF 

HT 

ISO:# 

CS ISO:fi 

CN ISO:n 

Paper tape 

220 

021 

022 

003 

024 

005 

006 

027 


Line printer 


= 

( 

) 

£ 

* 

9 

/ 

Card Reader 


= 

( 

) 

£ 

* 

9 

/ 

Normal Case 

ISO:& 

ISO:? 

ISO:! 

ISO:% 

ISO: ' 

ISO:$ 

ISO:- 

/ 

Shift Case 

ISO:& 

ISO:? 

ISO:! 

ISO:% 

ISO: ' 

ISO:$ 

ISO:- 


Paper tape 

030 

Oil 

012 

033 

014 

035 

036 

017 


Line printer 

0 

1 

2 

3 

4 

5 

6 

7 

Card Reader 

0 

1 

2 

3 

4 

5 

6 

7 

Normal Case 

0 

1 

2 

3 

4 

5 

6 

7 

Shift Case 

f ISO:" 

[ 

] 

< 

> 

= 

X 

-=- 

Paper tape 

060 

041 

042 

063 

044 

065 

066 

047 


Line printer 

8 

9 


10 ISO: s 

* 

+ 

- 


Card Reader 

8 

9 

ISO: 

to ISO: 2 

’ 

+ 

- 


Normal Case 

8 

9 

ISO: 

io ISO: 2 


+ 

- 


Shift Case 

( 

) 

ISO: 

£ 


* ISO:± 

* 

, 

Paper tape 

050 

071 

072 

053 

074 

055 

056 

077 


Line printer 


A 

B 

C 

D 

E 

F 

G 

Card Reader 

ISO:@ 

A 

B 

c 

D 

E 

F 

G 

Normal Case 

ISO:@ 

A 

B 

c 

D 

E 

F 

G 

Shift Case 

ISO:@ 

a 

b 

c 

d 

e 

f 

g 

Paper tape 

120 

101 

102 

123 

104 

125 

126 

107 


Line printer 

H 

I 

J 

K 

L 

M 

N 

O 

Card Reader 

H 

I 

J 

K 

L 

M 

N 

O 

Normal Case 

H 

I 

J 

K 

L 

M 

N 

O 

Shift Case 

h 

i 

j 

k 

1 

m 

n 

O 

Paper tape 

110 

131 

132 

113 

134 

115 

116 

137 


Line printer 

P 

Q 

R 

S 

T 

U 

V 

W 

Card Reader 

P 

Q 

R 

S 

T 

U 

V 

W 

Normal Case 

P 

Q 

R 

S 

T 

u 

V 

W 

Shift Case 

P 

q 

r 

s 

t 

u 

V 

W 

Paper tape 

140 

161 

162 

143 

164 

145 

146 

167 


Line printer 

X 

Y 

Z 






Card Reader 

X 

Y 

z 

ISO: { 

ISO:} 

-*ISO 

| 

ISO:\ 


Normal Case 

X 

Y 

z 

ISO: { 

ISO:} 

-> ISO 

j 

ISO:\ 


Shift Case 

X 

y 

z 

ISO: { 

ISO:} 

-*ISO 

j 

ISO:\ 


Paper tape 

170 

151 

152 

173 

154 

175 

176 

177 


This document is licensed under a Creative Commons Attribution 3.0 License : http://creativecommons.Org/licenses/by-nc-sa/3.0/ 

































































































































For ee9 V3.2, © 2018 William Findlay, last document revision: 2018-10-29 


15/28 


Appendix 3: KDF9 Graph 

Plotter Codes 

Action 

Deci 

mal 

Octal 

Binary 

None 

0 

#0 

000000 

Step paper back 

1 

#1 

000001 

Step paper forward 

2 

#2 

000010 

Step pen right 

4 

#4 

000100 

Step pen right, paper back 

5 

#5 

000101 

Step pen right, paper forward 

6 

#6 

000110 

Step pen left 

8 

#10 

001000 

Step pen left, paper back 

9 

#11 

001001 

Step pen left, paper forward 

10 

#12 

001010 

Lower pen 

16 

#20 

010000 

Raise pen 

32 

#40 

100000 


All other 6-bit character codes represent invalid plotter commands. 

It is confidently asserted that the plotter command list in Appendix 6, §5, p.302 of the Manual is wrong, as there is an 
obvious error whereby 11 plotting codes are claimed but only 9 are given, the last of them being inconsistent with the 
others. The present list provides the tw’o missing codes and corrects the incorrect code, given by the Manual as 001001, for 
a step right and backwards. 

The codes listed here have been confirmed by the evidence of other computers of the era that used the same plotter; the bit 
positions and their interpretations map directly onto the control bits in Calcomp’s hardware interface. See: 

https://ub.fnwi.uva.nl/computermuseum//calcomp565.html 
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Appendix 4: Director OUTs (system calls) 

Director, the English Electric operating system, provides a number of services that manage I/O devices, implement program 
overlay, and obtain timing information. These are accessed by the OUT instruction, executed with parameters in the NEST. 
In particular, N1 must contain the identifying number of the system service being requested. See Table A.4.1. 


Table A4.1: Director OUT parameters 


N1 

N2 

N3 

Action 

ot 



Terminate this run normally. 

It 

Program ... 

... name 

Terminate this run and overlay the program whose name is in N2-3. 

2f 

Time limit in seconds 


Restart this self-overwritten program. 

Allow it the new time limit given in N2. 

3t 



Return the CPU time used in N1. 

The result is given as seconds to 23 integral places. 

4$ 

Tape label 


Allocate the tape deck with the reel having the 1-word label in N2. 
Return its buffer number in N1. 

5$ 

Device type code 


Allocate an I/O device of the type given in N2; see Table A4.2. 

Return its buffer number in N1. 

6± 

Buffer number 


Deallocate the I/O device with buffer number in N1. 

If it is a tape deck, unload any mounted tape reel. 

7$ 

Buffer number 


Deallocate an allocated tape deck with buffer number in N1. 

Do not unload any mounted tape reel. 

8, #10$ 

Control word 


Spool output. 

See Appendix 5. 

9,#11$ 



Return the time of day in N1. 

The result is given as seconds since midnight to 23 integral places. 

10,#12$ 

Tape ... 

... label 

Allocate the tape deck with the reel having the 2-word label in N2-3. 
Return its buffer number in N1. 

17, #21$ 



Return the CPU Time in N1 and the Notional Elapsed Time in N2. 

The results are given as seconds to 23 integral places. 


f See the Manual, §26.2. 1. 

• Obeying OUT with an empty NEST has the same effect as OUT 0. 

• OUT 1 overlays the current program with a program read from external media. It is used by compile-and-go compilers. 
The program name for OUT 1 consists of 12 Normal Case characters, e.g. “KMW0301—UPU”. 

• OUT 2 starts the execution of a new program that has already been set up in core. It is used by in-core compilers. 

$ See the Manual, §17.3. 

• The tape label for OUT 4 consists of 8 Case Normal characters, e.g. “PRINTEND” 

• The tape label for OUT 10 consists of a plus sign followed by!5 Case Normal characters, e.g. “+KOUTPUT/0023004”. 


Table A4.2: Device Type Codes for OUT 5 


Type: 

FW 

TP 

TR 

LP 

CR 

CP 

GP 

Decimal 

0 

1 

2 

3 

4 

7 

16 

Octal 

#00 

#01 

#02 

#03 

#04 

#07 

#20 


Add 8 (#10) to these codes to reclaim a previously-relinquished device. 
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Appendix 5: OUT 8 

Director implements an output spooling system for paper tape punches and line printers. It also administers access to the 
console Flexowriter. Up to 64 virtual output streams are provided to each running problem program; see Table A5.1. 

Stream output is written first to a designated magnetic tape. When that becomes full, or at the behest of the computer 
operator, it is rewound and the accumulated data for each stream is transferred from the tape to its associated device. A 
second magnetic tape may be designated to take output while this is happening, and the two tapes may switch roles as often 
as necessary to transfer all the outputs to their intended destinations. 

OUT 8 takes a parameter word in N2 that controls the spooling action. It is in Q store format. If the C-, I-, and M-parts 
are equal, and contain a stream number, that stream is closed. Otherwise the I-part is taken to be the address, a, of an output 
area laid out as follows: 

• word a+0: stream number 

• word a+ 1: control word in Q store format: x 7 y / z 

If x = 4095 and y = -1, then a device-dependent ‘gap’ is written to the stream; for a tape punch this takes the form of 
runout (unpunched) tape, of length z characters; for a line printer it is a Page Change character. Otherwise, z is taken to be 
the address of the last word to be output, and the words in address range a +1 to z inclusive are written to the OUT 8 tape by 
a transfer-to-End-Message operation, word a +1 having been overwritten by ‘red tape’ identifying the stream. 


Table A5.1: OUT 8 streams implemented by Director 


stream number 

Output Device 

#10 .. 17 

A paper tape punch selected by the operator, in 8-hole mode 

#20 .. 27 

Not used 

#30 .. 37 

The line printer 

#40 .. 47 

Not used 

#50 .. 57 

A paper tape punch selected by the operator, in 5-hole mode 

#60 .. 67 

Not used 

#70 .. 77 

The line printer or a paper tape punch, at the operator’s discretion 


Special provision is made for prompted responses from the Flexowriter console, which are implemented immediately, 
not deferred. In this case the parameter word in N2 must have a C-part of #100000. The output area must be laid out with a 
prompt (ending with a ‘; ’ character) and be followed by an input area for the response. Various restrictions are imposed to 
preserve a tidy layout of the console’s typed log. In particular, word a +1 is overwritten by Director with suitable format 
effectors. 

In its problem program and test program modes, ee9 emulates OUT 8 not by spooling, but by directly transferring the 
output to the intended destination device. Note that outputs to multiple streams intended for the same device are therefore 
interleaved by ee9, but were not interleaved by Director. In doing so ee9 is somewhat more specific than Director in its 
provision of output streams, as indicated in Table A5.2. Streams 11, 13, 15 and 17 are directed to TP1 instead of TP0, as a 
small mitigation of the interleaving issue. The 5-hole mode is not implemented; all paper tape output is in 8-hole mode. So 
far these differences between ee9 and Director have not been problematic. 

Table A5.2: OUT 8 streams implemented by ee9 


stream number 

Output Device 

#00 

Flexowriter 

#10,12,14,16 

TP0 

#11,13,15,17 

TP1 

#30 .. 37 

LP0 

#50 .. 57 

TP1 

#70 .. 77 

LP0 

others 

Invalid 


The KDF9 Algol I/O procedures work on notional I/O streams, identified by decimal numbers that are made to look like 
OUT 8 octal stream numbers. For example, output to Algol stream 30 goes to OUT 8 stream #30. Algol input uses the 20 
range of stream numbers which OUT 8 does not use. 
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Appendix 6: Disassembled machine code 

The U format core printing routine traces the program’s control flow, and uses simple heuristics, to determine whether a 
given word represents data or instructions. These do a good job, but cannot always be correct. Words thought to be data are 
output in a variety of formats. Instructions are shown with octal or decimal operand addresses, at option. If the operand of a 
SET instruction is greater than 7, its octal representation is complemented by its decimal representation as a comment; or 
vice versa. 

An instruction that is the target of a jump starts a new line labelled by its address. An address is also given for the 
instruction sequentially following a subroutine jump (JS...), as that is the link value stored in the SJNS, and may be useful 
for following the course of execution. 

Here is an example for which the heuristics work well. Lines of the form Vn=value ; are local static data declarations; 
and the executable code begins with ‘VI4 ; =V13; 

P51V15; 

V0=F0.019042127887; 

V1=F0.019042129240; 

V2=F0.038082414120; 

V3=F0.076666493927; 

V4=F0.121226383896; 

V5=F0.725940450930; 

V11=Q6/1/0; 

V12=Q4/1/0; 

V14=F1.0; 

V15=F0.5; 

V14; =V13; 

DUP; DUP; xF; V14; +F; JSP40; =V6; 

V12; =Q13; 

2; V13; V6M13; +F; V15; *F; =V13; 

V13; V6M13Q; *F; JSP40; =V6M13; J2C13NZ; 

VI1; =Q13; 

V0M13Q; ZERO; REV; FIX; FLOATD; 

1; V0M13; V5M13Q; x+F; J1C13NZ; 

ROUNDF; -s-F; EXIT1; 


And here is its UD-format output: 


Core store interpreted as instructions. 

1393/0: #1742337743622052 = 68337217250346 = 1.90421278869E-2 

1394/0: #1742337743651250 = 68337217262248 = 1.90421292400E-2 

1395/0: #1744677611614626 = 68504697379222 = 3.80824141200E-2 

1409/0: 

E1407; =E1406; 

DUP; DUP; xF; E1407; +F; 

JSE1263/0; 

1411/4: 

=E1399; 

E1405; =Q13; 

1413/0: 

E1406; E1399M13; +F; E1408; xF; =E1406; 

E1406; E1399M13Q; xF; 

JSE1263/0; 

1417/0: 

=E1399M13; 

JE1413/0C13NZ; 

E1404; =Q13; E1393M13Q; ZERO; REV; FIX; FLOATD; 

1420/0: 

E1393M13; E1398M13Q; x+F; 

JE1420/0C13NZ; 

ROUNDF; DIVF; 

EXIT 1; 
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Appendix 7: Tracing 

Appendices 7 A and 7b illustrate tracing with the example of the Algol 60 sqrt function, represented in the Whetstone 
Controller by the routine P40. Here it is, with the starting address of each line of code indicated in octal: 


2357/0: 
2360/4: 
2361/3: 2; 
2363/0: 
2363/3: 
2364/3: 
2365/1: 
2366/0: 3; 


V0=0.46429/2; 

DUP; J1<=Z; FIX; DUP; SHLD-1; =M15; 
J2<Z; SHL-1; 

SHA-3; DUP; SHA+1; V0; +; (X0,M); 

DUPD; + ; +; (XI,M); 

DUPD; + ; REV; SHA-2; +; (X2,M); 

DUP; PERM; + ; +; (X3); 

Ml5; NOT; NEG; FLOAT; 

EXIT1; 


And here is how it looks when output by the disassembler in ee9: 

#02357/0: 

DUP; 

JE#02366/3LEZ; 

FIX; DUP; SHLD-1; =M15; 

JE#02361/3LTZ; 

SHL-1; 

#02361/3: 

SHA-3; DUP; SHA+1; E#002356; +; DUPD; DIV; +; DUPD; DIV; REV; SHA-2; 

+; DUP; PERM; DIV; +; Ml5; NOT; NEG; FLOAT; 

#02366/0: 

EXIT 1; 

P4 0 starts by checking that the argument is non-negative, then does 3 iterations of Newton’s method, starting with a 
linear approximation derived from V0. It is interesting that most of the calculation is done in fixed point arithmetic, which is 
both faster and more precise than floating point, with conversion to floating point format only at the end. 

Appendix 7a: The retrospective trace 

The redacted retrospective trace shown below begins at a call of P40 with an argument of 3.42551882080 in Nl, and ends 
when P40 returns to its caller with Nl holding the result 1.85081571768. 

Retrospective trace of all instructions. 


ND SD VT CPU TIME ICR 


Ended 

#02366/0: 

EXIT 1 

#02603/1 

2 

2 

134009606 

23627268 

After 

#02365/5: 

FLOAT 

1.85081571768E+0 

2 

3 

134009593 

23627267 

After 

#02365/4: 

NEG 

#0000000000000002 

3 

3 

134009585 

23627266 

After 

#02365/3: 

NOT 

#7777777777777776 

3 

3 

134009584 

23627265 

After 

#02365/1: 

M15 

#0000000000000001 

3 

3 

134009583 

23627264 

After 

#02365/0: 

+ 

#1663474170445362 

2 

3 

134009579 

23627263 

After 

#02364/5: 

DIV 

0.231351914901801 

3 

3 

134009578 

23627262 

After 

#02364/4: 

PERM 

#0731636127015617 

4 

3 

134009534 

23627261 

After 

#02364/3: 

DUP 

#0731636127015617 

4 

3 

134009532 

23627260 

After 

#02364/2: 

+ 

#0731636127015617 

3 

3 

134009530 

23627259 

After 

#02364/0: 

SHA-2 

#0355036532524012 

4 

3 

134009529 

23627258 

After 

#02363/5: 

REV 

#1664172552520047 

4 

3 

134009526 

23627257 

After 

#02363/4: 

DIV 

0.115600102325551 

4 

3 

134009525 

23627256 

After 

#02363/3: 

DUPD 

#1664172552520047 

5 

3 

134009489 

23627255 

After 

#02363/2: 

+ 

#1664172552520047 

3 

3 

134009485 

23627254 

After 

#02363/1: 

DIV 

0.239887685616871 

4 

3 

134009484 

23627253 

After 

#02363/0: 

DUPD 

#0710746172064044 

5 

3 

134009448 

23627252 

After 

#02362/5: 

+ 

#0710746172064044 

3 

3 

134009444 

23627251 

After 

#02362/2: 

E#002356 

#0355556654735604 

4 

3 

134009436 

23627250 

After 

#02362/0: 

SHA+1 

#0333167315126240 

3 

3 

134009430 

23627249 

After 

#02361/5: 

DUP 

#0155473546453120 

3 

3 

134009427 

23627248 

After 

#02361/3: 

SHA-3 

#0155473546453120 

2 

3 

134009425 

23627247 

After 

#02361/1: 

SHL-1 

#1554735464531200 

2 

3 

134009422 

23627246 

After 

#02360/4: 

JE#02 361/3LTZ 

#0000000000000001 

2 

3 

134009419 

23627245 

After 

#02360/2: 

=M15 

Q #000000/ #001174/ #000001 

3 

3 

134009408 

23627244 

After 

#02360/0: 

SHLD-1 

#0000000000000001 

4 

3 

134009406 

23627243 

After 

#02357/5: 

DUP 

#0000000000000002 

4 

3 

134009403 

23627242 

After 

#02357/4: 

FIX 

#0000000000000002 

3 

3 

134009401 

23627241 

After 

#02357/1: 

JE#02 366/3LEZ 

#2026663566322545 

2 

3 

134009395 

23627240 

After 

#02357/0: 

DUP 

#2026663566322545 

3 

3 

134009391 

23627239 

After 

#02603/1: 

JSE#02357/0 

#02603/1 

2 

3 

134009389 

23627238 

After 

#02603/0: 

+F 

3.42551882080E+0 

2 

2 

134009378 

23627237 


(etc) 


After earlier instructions, whose tracing is now lost. 
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Appendix 7b: The single-step trace 

In pause mode ee9 executes instructions one-by-one, interacting with the user at each step and presenting the values in the 
registers relevant to the instruction just obeyed. Here it is, stepping through P40: 


At #02603/1 (1411/1); ICR = 23627238; the instruction was #200:324:357, 

JB: #02603/1; SJNS depth: 3 

NEST: 

N1: 


#2026663566322545 = 71939055527269 

= Q #040555/ #116731/ #122545 
= #101 #155 #235 #331 #245 #145 

N2 : 

#2016165444271372 = 71346596967162 

= Q #040343/ #126221/ #071372 
= #100 #343 #254 #221 #162 #372 
ee9: Breakpoint: at #02357/0 (f:ast 


= 3.42551882080E+0 
= Q 16749/ -25127/ -23195 
= "O6V+V05E" 

= 1.55740772465E+0 
= Q 16611/ -21359/ 29434 

= "0,,LD7)Z" 

t:race | p:ause or q:uit)? 


i.e. JSE#02357/0 


At #02357/0 (1263/0); ICR = 23627239; the instruction was #042, i.e. DUP 
NEST: 

N1: 


#2026663566322545 = 71939055527269 

= Q #040555/ #116731/ #122545 
= #101 #155 #235 #331 #245 #145 

N2 : 

#2026663566322545 = 71939055527269 

= Q #040555/ #116731/ #122545 
= #101 #155 #235 #331 #245 #145 

N3 : 

#2016165444271372 = 71346596967162 

= Q #040343/ #126221/ #071372 
= #100 #343 #254 #221 #162 #372 
ee9: Breakpoint: at #02357/1 (f:ast 


= 3.42551882080E+0 
= Q 16749/ -25127/ -23195 
= "O6V+V05E" 

= 3.42551882080E+0 
= Q 16749/ -25127/ -23195 
= "O6V+V05E" 

= 1.55740772465E+0 
= Q 16611/ -21359/ 29434 

= "0,,LD7)Z" 

t:race | p:ause or q:uit)? 


At #02357/1 (1263/1); ICR = 23627240; the instruction was #203:104:366, i.e. JE#02366/3LEZ 
NEST: 

N1: 

#2026663566322545 = 71939055527269 = 3.42551882080E+0 

= Q #040555/ #116731/ #122545 = Q 16749/ -25127/ -23195 

= #101 #155 #235 #331 #245 #145 = "O6V+V05E" 

N2 : 

#2016165444271372 = 71346596967162 = 1.55740772465E+0 

= Q #040343/ #126221/ #071372 = Q 16611/ -21359/ 29434 

= #100 #343 #254 #221 #162 #372 = "0,,LD7)Z" 

ee9: Breakpoint: at #02357/4 (f:ast | t:race | p:ause or q:uit)? 


At #02357/4 (1263/4); ICR = 23627241; the instruction was #045, i.e. FIX 
NEST: 

N1: 

#0000000000000002 = 2 = 1.06910588404E-50 

= Q #000000/ #000000/ #000002 = Q 0/ 0/ 2 

= #000 #000 #000 #000 #000 #002 = " ®" 

N2 : 

#3331673151262400 = 120524728788224 = 5.77386452579E+26 

= Q #066635/ #154645/ #062400 = Q 28061/ -9819/ 25856 

= #155 #235 #331 #245 #145 #000 = "°9W9I64 " 

N3 : 

#2016165444271372 = 71346596967162 = 1.55740772465E+0 

= Q #040343/ #126221/ #071372 = Q 16611/ -21359/ 29434 

= #100 #343 #254 #221 #162 #372 = "0,,LD7)Z" 

ee9: Breakpoint: at #02357/5 (f:ast | t:race | p:ause or q:uit)? q 
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Appendix 7c: The external trace of all instruction types 


LOCATION 

ICR 

CPU TIME 

ND 

SD 

VT 

[Nl] 

INSTRUCTION 

#00000/0 

1 

8 

0 

0 



J#00012/0 

#00012/0 

2 

12 

1 

0 


#0000000000000002 

SETB2 

#00012/3 

3 

19 

2 

0 


#0000000000000005 

SETB5 

#00013/0 

4 

32 

1 

0 


#0000000000000002 

OUT 

#00013/3 

5 

35 

0 

0 



=C15 

#00236/2 

3439084 

19706693 

1 

2 

V 

#0000000000000004 

JS#00063/2 

#00063/2 

3439085 

19706697 

2 

2 

V 

#0000000000001243 

M2 

#00063/4 

3439086 

19706699 

3 

2 

V 

#0000000000001243 

DUP 

#00063/5 

3439087 

19706703 

2 

2 

V 

#0000000000002506 

+ 

#00064/0 

3439088 

19706705 

1 

2 

V 

#0000000000000004 

=M3 

#00064/2 

3439089 

19706709 

2 

2 

V 

#0000000000000001 

Ml 

#00064/4 

3439090 

19706715 

1 

3 

V 

#0000000000000004 

=LINK 

#00065/0 

3439091 

19706721 

2 

3 

V 

#0000000000000000 

E#253M3 


(etc) 

Appendix 7d: The peripheral I/O event trace 


Retrospective trace of peripheral I/O events. 


CPL EL. TIME 


Ended 

#00021/5: 

PGAPQ13 

TP0 

Q 

#000004/ 

#000000/ 

#000454 

P 

0 

E 

1668623742 

After 

#00021/5: 

PGAPQ13 

TP0 

Q 

#000004/ 

#000000/ 

#000454 

P 

0 

S 

1665896742 

After 

#00132/5: 

PWEQ14 

TP0 

Q 

#000004/ 

#072240/ 

#072435 

P 

0 

E 

1665896679 

After 

#00133/1: 

E#072240M7Q 

TP0 

Store Lockout at #072240 



@ 

1665887621 

After 

#00132/5: 

PWEQ14 

TP0 

Q 

#000004/ 

#072240/ 

#072435 

P 

0 

S 

1665887589 

After 

#00132/3: 

PREQ15 

TR1 

Q 

#000002/ 

#072240/ 

#072435 

P 

0 

E 

1665887589 

After 

#00132/5: 

POBQ14 

TR1 

Store Lockout at #072240 



@ 

1665886621 

After 

#00132/3: 

PREQ15 

TR1 

Q 

#000002/ 

#072240/ 

#072435 

P 

0 

S 

1665886589 

After 

#00157/5: 

PWQ14 

TP0 

Q 

#000004/ 

#072240/ 

#072240 

P 

0 

E 

1665886589 

After 

#00132/3: 

PIBQ15 

TP0 

Store Lockout at #072240 



e 

1665814046 

After 

#00157/5: 

PWQ14 

TP0 

Q 

#000004/ 

#072240/ 

#072240 

P 

0 

s 

1665813869 

After 

#00132/5: 

PWEQ14 

TP0 

Q 

#000004/ 

#072240/ 

#072435 

P 

0 

E 

3907430 

After 

#00133/1: 

E#072240M7Q 

TP0 

Store Lockout at #072240 



e 

2989972 

After 

#00132/5: 

PWEQ14 

TP0 

Q 

#000004/ 

#072240/ 

#072435 

P 

0 

s 

2989340 

After 

#00132/3: 

PREQ15 

TR1 

Q 

#000002/ 

#072240/ 

#072435 

P 

0 

E 

2989340 

After 

#00132/5: 

POBQ14 

TR1 

Store Lockout at #072240 



@ 

2888972 

After 

#00132/3: 

PREQ15 

TR1 

Q 

#000002/ 

#072240/ 

#072435 

P 

0 

S 

2888340 

After 

#00132/5: 

PWEQ14 

TP0 

Q 

#000004/ 

#072240/ 

#072435 

P 

0 

E 

2881126 

After 

#00133/1: 

E#072240M7Q 

TP0 

Store Lockout at #072240 



@ 

2808480 

After 

#00132/5: 

PWEQ14 

TP0 

Q 

#000004/ 

#072240/ 

#072435 

P 

0 

S 

2808406 

After 

#00132/3: 

PREQ15 

TR1 

Q 

#000002/ 

#072240/ 

#072435 

P 

0 

E 

2808406 

After 

#00132/5: 

POBQ14 

TR1 

Store Lockout at #072240 



@ 

2800480 

After 

#00132/3: 

PREQ15 

TR1 

Q 

#000002/ 

#072240/ 

#072435 

P 

0 

S 

2800406 

After 

#00132/5: 

PWEQ14 

TP0 

Q 

#000004/ 

#072240/ 

#072435 

P 

0 

E 

2799818 

After 

#00133/1: 

E#072240M7Q 

TP0 

Store Lockout at #072240 



@ 

2727172 

After 

#00132/5: 

PWEQ14 

TP0 

Q 

#000004/ 

#072240/ 

#072435 

P 

0 

S 

2727098 

After 

#00020/0: 

PGAPQ13 

TP0 

Q 

#000004/ 

#000000/ 

#000454 

P 

0 

E 

2727098 

After 

#00132/3: 

PREQ15 

TR1 

Q 

#000002/ 

#072240/ 

#072435 

P 

0 

E 

8164 

After 

#00132/5: 

PWEQ14 

TP0 

Buffer Lockout 




@ 

238 

After 

#00132/3: 

PREQ15 

TR1 

Q 

#000002/ 

#072240/ 

#072435 

P 

0 

S 

164 

After 

#00020/0: 

PGAPQ13 

TP0 

Q 

#000004/ 

#000000/ 

#000454 

P 

0 

S 

98 

After 

the start 

of traced execution. 







Total 

time waiting for unoverlapped I/O to 

finish = 

6707ms. 






Appendix 7e: The interrupt trace 
R etrospective trace of interrupt requests. 


Ended #03455/2: EDT 
After #03555/3: EDT 
After #03555/3: EDT 
After #02534/3: FLEX 

(etc) 


CPL EL. TIME ICR 

DO @ 69589893 3376330 

DO @ 69589259 3376231 

DO @ 69588608 3376134 

DO @ 69578533 3374471 


After earlier interrupts, whose tracing is now lost. 


ICR 

306451950 

306451950 

306451936 

306451936 

306451936 

306451934 

306451934 

306451934 

306451912 

306451932 

306451912 

1493 

1493 

1493 

1491 

1491 

1491 

145 

145 

145 

143 

143 

143 

28 

28 

28 

16 

27 

27 

27 

16 
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Appendix 7f: The instruction-type frequency histogram 


Histogram of the opcodes of 306451955 executed instruct 


017 : 

DUMMY 

9124116 

2.98% 

033: 

NOT 

3034643 

0.99% 

036: 

- 

5420458 

1.77% 

041: 

ZERO 

4249535 

1.39% 

042 : 

DUP 

22543966 

7.36% 

052 : 

ERASE 

14100897 

4.60% 

054 : 

AND 

1517321 

0.50% 

056: 

+ 

16813847 

5.49% 

065: 

REV 

3682555 

1.20% 

140: 

M+Iq 

5424042 

1.77% 

151: 

MqTOQk 

8613643 

2.81% 

164 : 

SHL 

20252652 

6.61% 

170: 

= [RHQ 

C|I|M}q 24281035 

7.92% 

171: 

{ Q | C | I 

M}q 39532258 

12.90% 

174 : 

=LINK 

11733524 

3.83% 

201: 

JrNE 

1361582 

0.44% 

206: 

JrNEZ 

1432592 

0.47% 

213: 

Jr 

19147853 

6.25% 

215: 

JSr 

12395115 

4.04% 

217 : 

EXIT 

24128639 

7.87% 

221: 

JrEQ 

1548396 

0.51% 

226: 

JrEQZ 

13369542 

4.36% 

300: 

EeMq 

28461446 

9.29% 

301: 

=EeMq 

6616138 

2.16% 

304 : 

SET 

4736277 

1.55% 


ions with frequency >= 




0.30% 


Appendix 7g: The instruction locus frequency histogram 


Histogram of the loci of 306451955 executed instructions with frequency >= 


#00063 

21524493 

7.02% 

#00064 

21524493 

7.02% 

#00065 

14349662 

4.68% 

#00066 

7174831 

2.34% 

#00073 

3791307 

1.24% 

#00075 

28793967 

9.40% 

#00076 

7174831 

2.34% 

#00077 

11635855 

3.80% 

#00100 

12165488 

3.97% 

#00101 

12165488 

3.97% 

#00110 

3274426 

1.07% 

#00112 

4667583 

1.52% 

#00113 

3073182 

1.00% 

#00114 

6069284 

1.98% 

#00115 

6069284 

1.98% 

#00207 

6742730 

2.20% 

#00210 

9439822 

3.08% 

#00211 

13485460 

4.40% 

#00212 

6573495 

2.15% 

#00213 

4552883 

1.49% 

#00216 

4552423 

1.49% 

#00236 

4539949 

1.48% 

#00242 

3371365 

1. 10% 


1 


Executions accounted for in the profile: 70.72% 


00 % 
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Appendix 8: Error messages 

In the following, a KDF9 instruction is represented by k, an I/O device name by d, a buffer number by b, an external file 
name by/, an address by a, a count by c, a device type code by t, a magnetic tape erasure type by g, an OUT 8 stream 
number by s, a plotter command code by p, and a magnetic tape label by /. 

LIV (Lock-In Violation): or Invalid operation attempted in Director: 

These are invalid operations that were detected as such by the KDF9 hardware, and caused a LIV interrupt when running in 
problem program mode. They did not interrupt in Director mode, but are always treated by ee9 as invalid, because they do 
not permit emulation to continue successfully. 

k cannot be used on d 

32K-1 < physical address = a 

32K-1 < virtual address = a 

attempt to read MT backwards at BOT 

attempt to read MT backwards to End_Message at BOT 

attempt to skip backwards at BOT 

attempt to use unallocated I/O device # b 

Director-only instruction 

initial address > final address = a 

invalid I/O Q operand: I > M 

negative I/O repetition count 

NOL < virtual address = a 

nonpositive I/O repetition count 

the buffer for d is abnormal (parity error or end-of-data) 

This was not actually detected by KDF9,1 believe, but it should have been; ee9 fails it: 

JCqNZS instruction at syllable 5 

Instruction not yet implemented: egdon outs are not yet supported 

Invalid operand detected: or Invalid operand detected in Director: 

These failures are caused by operands that cannot be correctly interpreted by ee9. 

A. Instructions acting on malformed MT reels might have caused warnings that operators would have responded to: 

attempt to erase a read-only MT 
attempt to GAP not within a WIPE on d 
attempt to skip or read past PET on d 
attempt to write a read-only tape 
attempt to write gap past PET on d 
attempt to write past PET on d 

cannot find a tape, given a null label by OUT4/OUT10 
erasing a gap of type g and length c would overwrite data on d 

B. Incorrect OUT parameters that would have been detected and failed by Director: 

invalid OUT number 

OUT 1: program name is an empty string 

OUT 5: no device of type t is available 

OUT 5: requested an invalid device type t 

OUT 6: device # b, is not allocated to this program 

OUT 7: device # b, is not a MT 

OUT 7: device # b, is not allocated to this program 

OUT 8: failure 73, invalid data for 0UT8 to FW 

OUT 8: invalid device for gapping # b 

OUT 8: invalid M-part # a 

OUT 8: invalid stream # s 

OUT 8: no device file for stream # s 

C. Incorrect radix data for FRB and TOB was not detected by KDF9 and gave wrong results; they fail in strict mode: 

invalid radix > 31 in FRB 
invalid radix > 31 in TOB 
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D. Miscellaneous errors that ee9 detects and fails: 

attempt to read FD at the end of a seek area 

attempt to write FD at the end of a seek area 

impossible movement for plotter from <x, y> by <dx, dy> 

infeasible PostScript bounding box size 

invalid DR sector number 

invalid FD drive number 

invalid GP command: #p 

The KDF9 OPERATOR MUST HAVE MADE A MISTAKE: 

These are errors in the configuration of the emulated KDF9 that result from mistakes made in the invocation of ee9; e.g. by 
running it in the wrong working directory, so that required device files are absent: 

d on buffer # b is offline 

attempt to MGAP d, which has no Write Permit Ring 
attempt to MWIPE d, which has no Write Permit Ring 
attempt to write to d, which has no Write Permit Ring 
OUT 5: the TP1/GP0 buffer has not been switched to GPO 
the file '/' cannot be found 
the MT labelled '/' has not been mounted 

Invalid paper tape file supplied: 

These errors are probably the result of the user not having set up an object program input tape in KDF9 code: 

d encountered a parity error at byte c 
d encountered an incomplete word at byte c 
d was given an empty file 

Apologies for this dismal failure: 

These are failures of internal consistency checks made by ee9. They should never happen, but are handled defensively, with 
a view to debugging ee9 itself: 

attempt to install a second device, namely d, on buffer # b 
cannot identify any buffer responsible for this lockout 

DIVR exceeds correction_count_limit for dividend / divisor = quotient R remainder 

DIVR overflows in DIVD for dividend / divisor 

Finalize error for FD buffer # b 

Finalize error for MT buffer # b 

Finalize for buffer # b ; reason 

find_start_of_earlier_block at slice c failed to locate the last slice of a block 
find_start_of_later_block at slice c failed to locate the first slice of a block 
in IOC. mnemonic for ' k' on device class 
in show_I0C_FIF0.show_transfer 
in tracing.the_note case test_buffer_status 

injecting a string of excessive length = c into the stream FWO 

injecting a string of length = 0 into the stream FWO 

injecting: a string into the closed FWO 

invalid buffer # b found in OUT c 

invalid code in IO_skeleton 

invalid code in normal_jump_skeleton 

invalid K-group order in show_retro_FIFO 

invalid miscellany flag 

invalid poke operation 

invalid poke position 

invalid RFI in KDF9.signal_interrupt 

invalid syndrome in data_access_skeleton 

not at BOT after rewinding d at slice c 

POSIX read failure in FD.get_next_sector 

POSIX seek failure in FD.get_next_sector 

POSIX seek failure in FD.put_next_sector 

POSIX write failure in FD.put_next_sector 

Q0 was set non-zero 

reading settings from file 

size = c > max_block_size in MT read_block 
wrong C-part: c for d on buffer # b 
The following are probably the result of the user not having set up a MT device file properly: 
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End_Error reading MT slice number c 
End_Error writing MT slice number c 


Each of the following messages from the host_I0 package accompanies the raising of an otherwise unhandled exception 
named stream_IO_error, and indicates that the execution environment is not conducive to running ee9. Each message 
includes a detailed diagnostic of the I/O stream concerned: 


cannot back_off 
FILE_SIZE: seek failure 
FLUSH 

GET_BYTE: POSIX_IO_error 
PUT_BYTE: POSIX_IO_error 
REATTACH 

REATTACH: standard input cannot be reopened 
REATTACH: the new mode is incompatible 
SET POSITION 


The diagnostic of the state of a EO stream takes the following form; the caption is either one of the messages above or an 
Ada exception message with more detail on an unanticipated failure: 

caption : 

base_name = d 
block_size = 
bytes_moved = ... 
fd = 

I0_mode = 
last_IO = 
next_byte = 
position = 
column = 


Each of the following messages from the POSIX package accompanies the raising of an otherwise unhandled exception 
named P0SIX_I0_error, and indicates that the execution environment is not compatible with running ee9. 

,v is the status code returned by the failing POSIX operation,/is a filename, // is a POSIX file descriptor number, and m 
is a message that failed to be output normally: 

s in close fd: fd 
s in create: / 
s in input 
s in open file: / 
s in output : m 
s in prompt: m 
s in read fd: fd 
s in response: fd 
s in seek fd: fd 
s in skipping line terminator 
s in truncate fd: fd 
s in write fd: fd 

Other error messages 

Each of the following messages indicates an unrecoverable error during either initialization or finalization: 
raised EXCEPTIONS.OPERATOR_ERROR : FDO cannot be found 

There is no file to represent the fixed disc drive device. Perhaps the result of invoking ee9 in the wrong working directory. 
Failure in finalize_ee9 s 

The error described by s was detected during diagnostic output at the end of a run. Should not happen. 8-) 
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Appendix 9: Operating a KDF9 with TSD 

The following material draws heavily on the EE document ‘A1020 - Time Sharing Director - Mark I’, by A. Doust and 
M.R. Wetherfield, the authors of the Time Sharing Director program. 

Commands from the computer operators to Director are known as ‘TINTs’, short for Typewiter Interrupts. They are 
initiated by pressing the interrupt button on the console Flexowriter. Director responds by typing TINT; and waiting for a 
command to be input. Each such command is terminated by typing ‘ With ee9, interrupt by CTRL-C and answer the 
prompt with Return. For shown below, type ‘ | ’. 

In the following, dd indicates a two-digit device (buffer) number; tt indicates a device type code (see Table B); p 
indicates a 12-character program name (also known as the PRN, or Program Reference Number); n is an octal number; / is a 
magnetic tape label; and s is a timesharing slot name (one of ‘P\ ‘Q’, ‘R’ or ‘S’). 

A s.-> 

Terminate program in slot s, or terminate its loading. 

A s+.-> 

Terminate program in slot 5 and type a basic diagnostic, showing the top of the SJNS and the NEST.. 

B s «.-» 

Read the octal integer n (up to 8 digits) and store its value into the less significant half of E0 of s. This can be used to 
convey options to the program at run time, separately from any tape or card data. 

C </</.-> 

Load the magnetic tape on unit dd. Director reads the tape label, notes it, and positions the tape at the block immediately 
following, ready for allocation to a program that requests it by name, using OUT 4 or OUT 10. 

D dd.-> 

Unload the magnetic tape on unit dd. The tape is rewound and disengaged from the deck, ready for removal. 

E rfr/A.-» and E ddB 

Nominate the magnetic tape loaded on unit dd for the input of A/B programs. 


F 

Dummy (used if interrupt key pressed in error). 


G.-> 

Type the peripheral unit list. 


H.-» 

Type a list of ‘wanted’ tape labels. These are tapes that programs have requested, but have not yet been loaded. 

I s0.-> 

Even restart for program ,v, i.e. make it execute the jump in the first halfword of word 0. This, and the odd restart, are for 
use when a program fails in a manner that has been anticipated, and can recover from. 

I s l.-» 

Odd restart for program s , i.e. make it execute the jump in the second halfword of word 0. 

L ddltt.-* 

Change the peripheral device unit dd to type tt. If tt = 0, the unit is deleted from the free list. 

Mr{s?}f4 

Output a store print in syllabic octal, x and y are both octal integers, y words are output, starting at address x: if y is 
omitted, 1 is understood. If {si} is P, Q, R or S then the base address of s is added to x. Any other separator (e.g. ‘/’) 
gives the absolute (Director) address x. 

R S.-» 

Resume s (after suspension). 

S s.-> 

Suspend s. 

T n/w 

Load a B-program and give it priority level n, with a store limit of w words. Absence of vv implies that the program may 
want the whole store. If the / is replaced by P the paper tape reader from which its call tape is read is pre-allocated to the 
program. 

A-programs are loaded on the initiative of Director, not the human operators. When the resources that are needed 
become available, Director says: 
n tt P dd s 
n APIU dds 

The operator must have presented the program's call tape on the A-program input unit dd. Director reads it in and 
continues: 

* date time 

ns P p or n s M p 

depending on whether the program itself is to be read from paper tape or magnetic tape. 
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U.-» 

For each program in the machine, type its slot letter (P, Q, R or S), 12 character identifier, priority, base address, and 
running and elapsed times so far. 

V «/«'.-» 

Put program in priority level n into priority level and vice versa. 

Z dd.+ 

Relabel the magnetic tape on unit dd. Director issues the query TN/ID ; to which the operator replies N //.-», e.g.: 

TN/lD;N/+DIRECTORBINWORK.-» 

Director confirms the change, e.g.: 

10L12 /Iden<+DIRECTORBINWORK>,TSN -00-0552 

When things go wrong 

If something goes wrong while reading in a program. Director types: 
n CRNP Fx 

where: CRNP means ‘Can't Read New Program’ and x is: 

0: No paper tape reader is available for reading the A-block; this applies to B-programs only. 

1: Parity failure in the A-block. 

2: the A-block not in correct form. 

3: C-block sum check failure. 

4: Parity failure in the B-block. 

5: E2 and E3 of the B-block are not the same as the first two words of the A-block. 

6: Program’s store requirement too large. 

7: Incorrect fillers for a C-block. 

8: Parity failure in a C-block. 

9: the unit specified by the A-block is not available for reading B-blocks and C-blocks. 

Program input can be terminated by giving a bogus A-block, thus inducing CRNP F2. B-program input can be terminated 
by the operator: if no reader is available, TINT A s.-» causes CRNP F0, but after the A and B blocks have been read, and 
the program is waiting for core store, it causes CRNP F6. 

In the event of a problem program failing. Director types: 

n s FAILS indicator [SJNS, Nl, N2 and NEST depth, where needed] 

REACT; 

This gives the operator the opportunity to abandon, or to restart the run, using A s.-», I v0.->, or I The indicator is 

taken from the following list of two or three digit codes: 

00L Lock-in violation 

00N Nest or SJNS over- or under-flow 

00T Time limit exceeded 

01 Incorrect OUT number (it is still in Nl) 

02 Failure in OUT 5 
0 3 Failure in OUT 6 or OUT 7 

04 OUT 4 or OUT 10 requests an unavailable tape 
0 5 OUT 1 obeyed with less than 3 items in nest 

0 6 OUT 1 obeyed with incorrect program name 

0 7 OUT 4 specifies incorrect identifier 

11 OUT 10 specifies incorrect identifier 
7 2 Wrong terminator to output block in OUT 8 
7 3 Incorrect character in OUT 8 block for the Flexowriter 
7 4 Invalid stream number in OUT 8 
7 5 No magnetic tape available for OUT 8 
7 6 Parity failure in OUT 8 output 
7 7 Invalid addresses for an OUT 8 block 
The following failures do not give the option of a restart, i.e. REACT ; is not typed: 

10 CRNP failure in OUT 1 

2 0 Incorrect program name in OUT 2 

21 Time limit for OUT 2 absent or incorrect 

2 2 OUT 2 obeyed with incorrect store limit in El 
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Normal termination 

When a program finishes without detected failure, the following message is typed out: 
n pi / lei run time / n.e.t./ elapsed time 

where: run time is the CPU time used; n.e.t. is the ‘notional elapsed time’ which gives an estimate of the elapsed time 
would have been experienced had there been no delays due to multiprogramming; elapsed time is the ‘wall clock’ time 
since the program started; and e is the ‘ending number’, which gives the reason for termination, namely: 

0: OUTO 

2: OUT 2 

4: TINT A 

5: CRNP in OUT 1 

6: any failure in OUT 2 

7: result of any response to REACT ; 

In the case of successful overlay by OUT 1, Director types the priority, slot and name of the new program: 
ns OUT 1 
n M p 


‘Descriptors’ 

Messages of the form: 

tt S dd s 

indicate that unit dd is of type tt and has current status S. For units other than magnetic tape units, when the unit is 
unallocated S is the letter U. When the unit is pre-allocated to a program or allocated to a program, .S' is P or A respectively. 
5 indicates the program to which the unit is (pre-)allocated. When a unit is allocated to Director (e.g. for TINT M), S is the 
letter D. 

For magnetic tape units, these messages are only typed when the unit becomes loaded (L) or unloaded (U), except when the 
whole unit list is typed by TINT G). They then also include the Tape Serial Number (TSN) of the tape, e.g.: 

10L12/Iden<PRINTEND>, TSN -20-0403 

10L13/Ident< ZERQ >, TSN -20-0284 

When a list is typed by TINT G, the identifiers of tapes on loaded units only are typed, and the TSN is omitted, e.g. 

10L12 PRINTEND 
10L13 

When a unit is allocated or deallocated by a program, the descriptor is typed in the relevant column for P, Q, R or S. The 
only exceptions to this are the pre-allocation messages preceding A-program input, and messages concerning magnetic tape 
units. These are always typed in the Director column. 

Waiting for ... 

Messages of the form: 

s WAITING FOR TYPE tt 

mean that program 5 (which must in this case be a B-program) has attempted to allocate to itself a unit of type tt , but none 
is available. The operators have to decide whether or not to terminate program 5 (or another B-program), in order to free a 
device of type tt, or let it wait for one to be freed voluntarily. 
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